From 1c33042a5773b195cc93a23b2227719e11e14a8a Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Sat, 26 May 2007 20:22:51 +0000
Subject: [PATCH] Bring docs in shape

svn path=/trunk/; revision=17935
---
 ChangeLog                           |  1 +
 docs/reference/gtk/Makefile.am      |  1 -
 docs/reference/gtk/gtk-sections.txt | 52 +++--------------------------
 gtk/gtkscalebutton.c                | 29 ++++++++--------
 4 files changed, 20 insertions(+), 63 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index d835a8cf2c..2328716ee3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,6 @@
 2007-05-26  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/gtkscalebutton.c:
 	* gtk/gtkrecentaction.c:
 	* gtk/gtkrange.c:
 	* gtk/gtkprinter.c:
diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index 19f6adf676..79fdf292c6 100644
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -88,7 +88,6 @@ IGNORE_HFILES=				\
 	gtktreeprivate.h		\
 	gtktypebuiltins.h		\
 	gtkxembed.h			\
-	gtkwindow-decorate.h		\
 	gtkwin32embed.h			\
 	gtkwin32embedwidget.h		\
 	xdgmime				\
diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index 17d9192cf1..8dcfd7a04c 100644
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -472,43 +472,6 @@ GTK_BUTTON_GET_CLASS
 gtk_button_get_type
 </SECTION>
 
-<SECTION>
-<FILE>gtkscalebutton</FILE>
-<TITLE>GtkScaleButton</TITLE>
-GtkScaleButton
-gtk_scale_button_new
-gtk_scale_button_set_icons
-gtk_scale_button_get_value
-gtk_scale_button_get_adjustment
-gtk_scale_button_set_adjustment
-<SUBSECTION Standard>
-GTK_TYPE_SCALE_BUTTON
-GTK_SCALE_BUTTON
-GTK_IS_SCALE_BUTTON
-GTK_SCALE_BUTTON_CLASS
-GTK_IS_SCALE_BUTTON_CLASS
-GTK_SCALE_BUTTON_GET_CLASS
-<SUBSECTION Private>
-gtk_scale_button_get_type
-GtkScaleButtonPrivate
-</SECTION>
-
-<SECTION>
-<FILE>gtkvolumebutton</FILE>
-<TITLE>GtkVolumeButton</TITLE>
-GtkVolumeButton
-gtk_volume_button_new
-<SUBSECTION Standard>
-GTK_VOLUME_BUTTON
-GTK_TYPE_VOLUME_BUTTON
-GTK_IS_VOLUME_BUTTON
-GTK_VOLUME_BUTTON_CLASS
-GTK_IS_VOLUME_BUTTON_CLASS
-GTK_VOLUME_BUTTON_GET_CLASS
-<SUBSECTION Private>
-gtk_volume_button_get_type
-</SECTION>
-
 <SECTION>
 <FILE>gtkcalendar</FILE>
 <TITLE>GtkCalendar</TITLE>
@@ -3091,8 +3054,10 @@ gtk_scale_button_get_adjustment
 gtk_scale_button_get_value
 <SUBSECTION Standard>
 GTK_SCALE_BUTTON
-GTK_SCALE_IS_BUTTON
+GTK_IS_SCALE_BUTTON
 GTK_TYPE_SCALE_BUTTON
+GTK_SCALE_BUTTON_CLASS
+GTK_IS_SCALE_BUTTON_CLASS
 GTK_SCALE_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_scale_button_get_type
@@ -3809,8 +3774,6 @@ GTK_TEXT_CHILD_ANCHOR_GET_CLASS
 gtk_text_view_get_type
 gtk_text_child_anchor_get_type
 GtkTextBTree
-GtkTextChildBody
-GtkTextPixbuf
 GtkTextWindow
 GtkTextPendingScroll
 </SECTION>
@@ -4137,11 +4100,6 @@ gtk_tooltip_set_icon
 gtk_tooltip_set_icon_from_stock
 gtk_tooltip_set_custom
 gtk_tooltip_trigger_tooltip_query
-gtk_tooltip_focus_in
-gtk_tooltip_focus_out
-gtk_tooltip_toggle_keyboard_mode
-gtk_tooltip_handle_event
-gtk_tooltip_hide
 <SUBSECTION Standard>
 GTK_TYPE_TOOLTIP
 <SUBSECTION Private>
@@ -4648,8 +4606,6 @@ gtk_tree_view_get_type
 <FILE>gtkcellview</FILE>
 <TITLE>GtkCellView</TITLE>
 GtkCellView
-gtk_cell_view_get_use_fg
-gtk_cell_view_set_use_fg
 gtk_cell_view_new
 gtk_cell_view_new_with_text
 gtk_cell_view_new_with_markup
@@ -4964,6 +4920,8 @@ gtk_volume_button_new
 GTK_VOLUME_BUTTON
 GTK_IS_VOLUME_BUTTON
 GTK_TYPE_VOLUME_BUTTON
+GTK_VOLUME_BUTTON_CLASS
+GTK_IS_VOLUME_BUTTON_CLASS
 GTK_VOLUME_BUTTON_GET_CLASS
 <SUBSECTION Private>
 gtk_volume_button_get_type
diff --git a/gtk/gtkscalebutton.c b/gtk/gtkscalebutton.c
index 822913e1a1..6f38b5d5bc 100644
--- a/gtk/gtkscalebutton.c
+++ b/gtk/gtkscalebutton.c
@@ -408,16 +408,15 @@ gtk_scale_button_dispose (GObject *object)
 /**
  * gtk_scale_button_new
  * @size: a stock icon size
- * @lower: the minimum value of the scale (usually 0)
- * @upper: the maximum value of the scale (usually 100)
- * @step_increment: the stepping of value when a scroll-wheel event,
- * or up/down arrow event occurs (usually 2)
+ * @min: the minimum value of the scale (usually 0)
+ * @max: the maximum value of the scale (usually 100)
+ * @step: the stepping of value when a scroll-wheel event,
+ *        or up/down arrow event occurs (usually 2)
  * @icons: a %NULL-terminated array of icon names, or %NULL if
- * you want to set the list later with gtk_scale_button_set_icons(). See
- * gtk_scale_button_set_icons() for details.
+ *         you want to set the list later with gtk_scale_button_set_icons()
  *
- * Creates a #GtkScaleButton, with a range between lower and upper, with
- * a stepping of step_increment.
+ * Creates a #GtkScaleButton, with a range between @min and @max, with
+ * a stepping of @step.
  *
  * Return value: a new #GtkScaleButton
  *
@@ -425,9 +424,9 @@ gtk_scale_button_dispose (GObject *object)
  */
 GtkWidget *
 gtk_scale_button_new (GtkIconSize   size,
-		      gdouble       lower,
-		      gdouble       upper,
-		      gdouble       step_increment,
+		      gdouble       min,
+		      gdouble       max,
+		      gdouble       step,
 		      const gchar **icons)
 {
   GtkScaleButton *button;
@@ -439,10 +438,8 @@ gtk_scale_button_new (GtkIconSize   size,
   if (icons != NULL)
     gtk_scale_button_set_icons (button, icons);
 
-  gtk_range_set_range (GTK_RANGE (priv->scale), lower, upper);
-  gtk_range_set_increments (GTK_RANGE (priv->scale),
-			    step_increment,
-			    10 * step_increment);
+  gtk_range_set_range (GTK_RANGE (priv->scale), min, max);
+  gtk_range_set_increments (GTK_RANGE (priv->scale), step, 10 * step);
 
   if (priv->size != size)
     {
@@ -541,6 +538,8 @@ gtk_scale_button_set_icons (GtkScaleButton  *button,
  * Gets the #GtkAdjustment associated with the #GtkScaleButton's scale.
  * See gtk_range_get_adjustment() for details.
  *
+ * Returns: the adjustment associated with the scale
+ *
  * Since: 2.12
  */
 GtkAdjustment*
-- 
2.30.2